home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / stensi.z / stensi
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssstttteeeennnnssssiiii((((3333GGGG))))                                                          sssstttteeeennnnssssiiii((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssstttteeeennnnssssiiii - specify the number of bit planes desired to comprise the stencil
  10.      buffer
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssstttteeeennnnssssiiii((((ppppllllaaaannnneeeessss))))
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 ppppllllaaaannnneeeessss
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _p_l_a_n_e_s   is the number of bit planes requested to be configured as
  18.               stencil planes.  Only values 0 through 8 are accepted.  The
  19.               default is 0.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      sssstttteeeennnnssssiiii specifies how many bit planes are requested to be configured as
  23.      stencil planes.  The constraints on _p_l_a_n_e_s are machine dependent.  Call
  24.      ggggeeeettttggggddddeeee((((GGGGDDDDBBBBIIIISSSSTTTT)))) to determine the maximum number of bit planes available
  25.      for stencil operation.
  26.  
  27.      sssstttteeeennnnssssiiii takes effect only after ggggccccoooonnnnffffiiii has been called.  The number of bit
  28.      planes granted for the stencil buffer may not be exactly what was
  29.      requested.  Call ggggeeeettttggggccccoooo((((GGGGCCCCSSSSTTTTEEEENNNN)))) to determine how many bit planes were
  30.      configured as stencil buffer planes.
  31.  
  32.      Because stencil bit planes are available only in the normal framebuffer,
  33.      sssstttteeeennnnssssiiii should be called only while draw mode is NNNNOOOORRRRMMMMAAAALLLL.
  34.  
  35. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  36.      drawmo, gconfi, getgco, stenci, mssize
  37.  
  38. NNNNOOOOTTTTEEEESSSS
  39.      This routine is available only in immediate mode.
  40.  
  41.      IRIS-4D B, G, GT, and GTX models, as well as the Personal Iris, Indy,
  42.      Iris Indigo Entry, and XL, do not support sssstttteeeennnnssssiiii.
  43.  
  44.      XS, XS24, XZ, Elan and Extreme systems support up to 4 stencil planes,
  45.      which are borrowed from the Z buffer. The resolution of the Z buffer
  46.      decreases when using stencil planes on Elan systems.
  47.  
  48.      On the IRIS-4D RealityEngine models the stencil buffer and the stencil
  49.      component in the multisample buffer are independent.  When the
  50.      multisample buffer is requested in the current framebuffer configuration,
  51.      it is recommended to call sssstttteeeennnnssssiiii((((0000)))), as no stencil buffer planes are
  52.      required.
  53.  
  54. BBBBUUUUGGGGSSSS
  55.      IRIS-4D VGX machines without the optional alpha bit planes allocate
  56.      stencil bit planes from the least-significant Z buffer bit planes.  Z
  57.      buffer operation compensates for this allocation automatically, so the
  58.      programmer is aware of the allocation only when the Z buffer contents are
  59.      read back using llllrrrreeeeccccttttrrrr.  Use ggggeeeettttggggddddeeee to determine whether your machine has
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssstttteeeennnnssssiiii((((3333GGGG))))                                                          sssstttteeeennnnssssiiii((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      alpha bit planes.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.